Inside Macintosh: Programming With the Text Encoding Conversion Manager /

Chapter 3 - Text Encoding Converter Reference / Text Encoding Converter Functions

Creating and Deleting Converter objects /

TECDisposeConverter

Disposes of a converter object.

pascal OSStatus TECDisposeConverter (TECObjectRef newEncodingConverter);

newEncodingConverter

A reference to the text encoding converter object to be removed. This can be the reference returned by the function TECCreateConverter (page 91), TECCreateConverterFromPath (page 92), or TECCreateOneToManyConverter (page 99).

function result

A result code. See "Text Encoding Conversion Manager Result Codes" (page 42) for a list of possible values.

DISCUSSION

You use TECDisposeConverter to dispose of an encoding converter object and its associated reference when you have finished using it. Do not specify a converter object reference as a parameter to another function after you use TECDisposeConverter to dispose of it.

If you want to reuse the converter object for a different text stream with the same source and destination encoding, you should clear the converter object using the function TECClearConverterContextInfo (page 94) rather than dispose of it and create the object again.